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Purpose 


This action is used to get a pdf copy of the page. 


It does an on-the-fly, server-side, html to pdf conversion using htmldoc, and sends an application/pdf content 
to the web browser. 


Calling sequence 


http://my.server/MyWiki/MyPage?action=pdf 
http://my.server/MyWiki/MyPage?action=pdf&style=NAME 
http://my.server/MyWiki/MyPage?action=pdf&rev=NUM 
http://my.server/MyWiki/MyPage?action=pdf&pageaction=ACTION 


http://my.server/MyWiki/MyPage?action=pdf&help 


style: 
() page or book. These styles can be redefined or extended in the wiki config (see below). Asking for 
an unknown style will display an error and list available styles. 
rev: 
() Specifies a page version number. 
pageaction: 
() Specifies an action for rendering the page. By default and if omitted, the print action will be used. 
help: 
() Displays this help. 
Procedure 
Usage: 


e Append &action=pdf to any URL 
e or insert the macro [ [pdf ] ] (coming soon!) in a page, which will insert a small control panel 


Hints: 
e In book style, htmldoc automatically generates a table of contents. This can cause confusion if the 
[[TableOfContents] ] macro is used. The TOC from htmldoc is looking nicer (has page numbers) but 
cannot be placed freely in the document. 


Upon your liking, either 


1/3 


Pascal/Moin Moin Extensions Project/Pdf Action - Bauermeisters Wiki 05/25/06 10:57:52 


tolerate dual TOCs, 
% or adapt the wiki page for pdf book output: don't use the [[TableOfContents ] ] macro, 
% or use the macro and disable htmldoc TOC globally: redefine the book style with the --no-toc 
option, 
% or create a style (e.g book-notoc) having the --no-toc option. 
Suggestions: 


e Modify your themes to include a pdf link/icon besides print. 
e Modify the AttachFile standard action to add a pdf link. 


Installation 


1. install htmldoc on the wiki server (on a Debian box: apt-get install htmldoc) 
2. copy the_pdf.py action to the data/plugin/action directory of your wiki 


Optional: customizing styles 


To install new styles, or modify the default ones, edit wikiconfig.py and add: 


htmldoc_styles = { 


"page": 
"--verbose --no-localfiles --no-compression --jpeg " \ 
"--header t.D --footer ./. --size a4 --left 0.5in " \ 
"--webpage", 

"book": 
"--verbose --no-localfiles --no-compression --jpeg " \ 
"--header t.D --footer ./. --size a4 --left 0.5in", 

} 


By this means, you can change the page format from a4 to letter, or add new styles to the dictionary. 


For a complete list of available htmidoc options, see_http://www.easysw.com/htmldoc/docfiles/8—cmdref.html 


Modification History 


@copyright: 2006 by Pascal Bauermeister 
(license: GNU GPL, see COPYING for details. 


Initial 
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